home *** CD-ROM | disk | FTP | other *** search
/ Cream of the Crop 1 / Cream of the Crop 1.iso / BUSINESS / CPGNZ22.ARJ / README.DOC < prev    next >
Text File  |  1991-08-26  |  15KB  |  344 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.                             Capital Gainz Version 2.2
  8.              Copyright 1991 by David Lee Cohen. All Rights Reserved.
  9.  
  10.                                    Dave Cohen
  11.                                      DBLinx
  12.                                  P.O. Box 12545
  13.                                RTP, NC  27709-2545
  14.                                  (919)-469-5196
  15.                             CompuServe ID: 70431,132
  16.  
  17.                                  August 26, 1991
  18.                            _______ 
  19.                       ____|__     |               (tm) 
  20.                    --|       |    |------------------- 
  21.                      |   ____|__  |  Association of 
  22.                      |  |       |_|  Shareware 
  23.                      |__|   o   |    Professionals 
  24.                    -----|   |   |--------------------- 
  25.                         |___|___|    MEMBER 
  26.       
  27.  
  28.          This is an unregistered shareware version of Capital Gainz if:
  29.  
  30.           - it was obtained via an electronic bulletin board, on-line
  31.           service, or other electronic means 
  32.                                    or
  33.           - it was obtained from a shareware disk vendor, or a source other
  34.           than David Lee Cohen
  35.                                    or
  36.           - during program sign-on the legend "shareware version" is
  37.           displayed.
  38.  
  39.      Otherwise, this is a registered version of Capital Gainz, purchased by
  40.      and registered to you. If this is a shareware version of Capital
  41.      Gainz, after installation refer to the document LICENSE.DOC (or print
  42.      the order form on program exit) for details on the shareware version's
  43.      restrictions and for information on ordering a registered version of
  44.      Capital Gainz. Also included in this document is a list of what you
  45.      get with your Capital Gainz registration.
  46.  
  47.          Capital Gainz is distributed on one or two diskettes, containing
  48.      this file, README.DOC, the INSTALL.COM installation program, the
  49.      program archive CPGNZP.zzz, and the documentation archive CPGNZD.zzz
  50.      ('zzz' is 'EXE' for a self-extracting archive, or else it indicates
  51.      the compression method used, such as 'ZIP'). The shareware version
  52.      also contains disk vendor information in the VENDOR.DOC file.
  53.  
  54.          If needed, an upgrade utility is included with registered versions
  55.      of Capital Gainz.
  56.  
  57.          Capital Gainz requires an IBM personal computer or compatible
  58.      running MS-DOS version 3.00 or later, any monochrome or CGA/EGA/VGA
  59.  
  60.  
  61.  
  62.  
  63.  
  64.      monitor, a minimum of 512KB of RAM, and a hard disk (strongly
  65.      recommended). The Capital Gainz User's Manual contains detailed
  66.      requirements along with disk space usage statistics for the Capital
  67.      Gainz data files. 
  68.  
  69.          Although Capital Gainz has been reasonably tested for reliability
  70.      and accuracy, you should backup your data regularly. This should
  71.      especially be done before any data file upgrade. Any bugs or
  72.      inaccuracies should be reported, and every effort will be made to fix
  73.      them. 
  74.  
  75.         Forward bug reports, problems, questions, suggestions, or general
  76.      feelings about Capital Gainz to the address at the top of this
  77.      document. And thanks for trying Capital Gainz.
  78.  
  79.  
  80.      Distribution, Registration:
  81.      ---------------------------
  82.          Capital Gainz is Copyright 1991 by David Lee Cohen.
  83.  
  84.          Distribution restrictions are detailed in the VENDOR.DOC file.
  85.      This software is not public domain, and failure to abide by the
  86.      distribution restrictions constitutes a violation of the U.S.
  87.      Copyright laws.
  88.  
  89.          Registration requirements are discussed in LICENSE.DOC. This file
  90.      also contains a registration form, or one can be printed upon program
  91.      exit.
  92.  
  93.      Upgrading to a New Revision or
  94.      Converting to a Registered Version
  95.      -----------------------------------
  96.          If you already have a shareware or registered version of Capital
  97.      Gainz installed, install the new registered version in the same
  98.      directory. Only program and documentation files will be overwritten -
  99.      data files will remain, but may be upgraded. 
  100.  
  101.          Sometimes, a change in file formats requires an upgrade of
  102.      existing data files. If this is the case, the upgrade utility will
  103.      either be on one of the distributed disks. This upgrade utility will
  104.      be invoked automatically by the INSTALL program. IF YOU ARE UPGRADING,
  105.      YOU SHOULD INSTALL THE NEW VERSION IN THE DIRECTORY CONTAINING THE OLD
  106.      PROGRAM AND DATA FILES. When attempting to run a new version of
  107.      Capital Gainz against old data files that were not upgraded, you may
  108.      receive the error "INVALID RECORD DECLARATION" when running Capital
  109.      Gainz. If you experience this problem, see UPDATE.DOC for information
  110.      on manually running the UPGRADE program.
  111.  
  112.          The upgrade utility is only available with the registered version
  113.      of Capital Gainz. DO NOT TRY TO INSTALL A NEW UNREGISTERED VERSION ON
  114.  
  115.                                                                           2
  116.  
  117.  
  118.  
  119.  
  120.  
  121.      TOP OF AN EXISTING VERSION.
  122.  
  123.          The HISTORY.DOC file contains a list of major changes between
  124.      revisions of Capital Gainz. A couple of important notes:
  125.  
  126.           - The first time you start version 2.2, you'll be asked for a
  127.           price history interval to construct the price history file. The
  128.           default - 28 days - allows for price histories approximately
  129.           monthly. You'll also be asked if you want to extract prices from
  130.           the activity logs - you should answer 'Y'. This allows security
  131.           prices from the buy/sell logs to be incorporated into the new
  132.           Price History file. 
  133.           - The new Tax Exempt flag - for retirement accounts - in the
  134.           Security file is initialized to 'NO' for all securities.
  135.           - If you are using transaction logging, you may notice slightly
  136.           slower performance due to the additional I/O for the new price
  137.           history file.
  138.  
  139.      Installation
  140.      ------------
  141.          Capital Gainz must be installed from a floppy disk drive. If you
  142.      downloaded it electronically:
  143.  
  144.           You should have the following files: README.DOC, VENDOR.DOC,
  145.           INSTALL.COM, CPGNZP.zzz, and CPGNZD.zzz ('zzz' is 'EXE' for a
  146.           self-extracting archive, or else it indicates the compression
  147.           method used, such as 'ZIP'). These files can all be put on the
  148.           PROGRAM disk, or the CPGNZD.zzz file can be put on the DOC disk
  149.           and the other files put on a PROGRAM disk.
  150.  
  151.          To install Capital Gainz, simply insert the PROGRAM disk into one
  152.      of your PC's floppy diskette drives and (assuming you inserted the
  153.      diskette into drive A) type:
  154.  
  155.          A:INSTALL
  156.  
  157.      You will be prompted for the necessary information, and any
  158.      directories requested will be created if they do not exist. If you are
  159.      installing a registered version, you will also be prompted for the
  160.      Registration Number on the distribution diskette. If there is a
  161.      separate UPGRADE or DOC disk, you'll be prompted to insert it as
  162.      needed. After installation, the new Capital Gainz directory will be
  163.      your current working directory.
  164.  
  165.      CONFIG.SYS File
  166.      ---------------
  167.          The maximum number of open files allowed, as indicated by the
  168.      'FILES=nn' statement in the CONFIG.SYS file in your root directory,
  169.      may need to be increased in order to run Capital Gainz. Given normal
  170.      configurations, a setting of FILES=30 should be sufficient - but you
  171.  
  172.                                                                           3
  173.  
  174.  
  175.  
  176.  
  177.  
  178.      may need to bump it up to 40. If there is no 'FILES=nn' statement in
  179.      your CONFIG.SYS file, or if 'nn' is less than 30, edit the file to
  180.      include the statement 'FILES=30'. You must reboot your system for this
  181.      new setting to be in effect.  
  182.  
  183.      Documentation
  184.      -------------
  185.          After installation is complete, these three important Capital
  186.      Gainz documents will be on your disk:
  187.  
  188.           README.DOC - this file.
  189.  
  190.           LICENSE.DOC - information on ordering the registered version of
  191.           Capital Gainz and the Capital Gainz license agreement.
  192.  
  193.           CAPGNZ.DOC - Capital Gainz user's manual (100+ pages). The online
  194.           version of the manual does NOT include screen shots.
  195.  
  196.          You'll probably want to print these files out:
  197.  
  198.          COPY README.DOC PRN
  199.          COPY LICENSE.DOC PRN
  200.          COPY CAPGNZ.DOC PRN
  201.  
  202.          If you want to reclaim the space used by the documentation, you
  203.      can delete all of the documents:
  204.  
  205.          DEL *.DOC
  206.  
  207.           (Shareware disk vendors should read VENDOR.DOC for distribution
  208.           restrictions.)
  209.  
  210.      Getting Started
  211.      ---------------
  212.          If you don't want to read the Capital Gainz User's Manual before
  213.      getting started, at least make sure that you skim this file,
  214.      README.DOC, in its entirety for important information. Also be sure to
  215.      refer to the LICENSE.DOC file for usage and distribution guidelines,
  216.      as well as restrictions that apply if this is an unregistered
  217.      shareware version of Capital Gainz. To start up Capital Gainz, type:
  218.  
  219.          CAPGNZ
  220.  
  221.      in the directory you specified during installation.
  222.  
  223.          Capital Gainz data files (*.DAT and *.K01) and help files (*.HLP)
  224.      must be located in the directory that you're in when you start Capital
  225.      Gainz. The DOS search path can be used to locate the Capital Gainz
  226.      executable file. 
  227.  
  228.  
  229.                                                                           4
  230.  
  231.  
  232.  
  233.  
  234.  
  235.      Backing Up Data
  236.      ---------------
  237.          I strongly urge you to regularly backup your Capital Gainz data
  238.      files. There is a Backup option on the Main Menu that executes the
  239.      backup command entered in the Global Settings Form, but since data
  240.      files must be closed and data swapped to disk before calling DOS, this
  241.      option may prove too slow on older 8086 PCs. If this is the case, use
  242.      your favorite backup or compression utility to backup the data files
  243.      before or after running Capital Gainz. Alternatively, you can use the
  244.      DOS COPY command in a batch file to copy the data files to a backup
  245.      diskette.
  246.  
  247.          The data files that should be backed up are identified by the
  248.      following DOS file templates:
  249.  
  250.          *.DAT
  251.          *.K01
  252.  
  253.      Included in this release is an example batch file, CAPGNZBU.BAT, that
  254.      backs up Capital Gainz data files using the DOS COPY command.
  255.      CAPGNZBU.BAT accepts the letter of the drive to copy the data files to
  256.      as its only arguments. Thus, to backup data from the current directory
  257.      to the diskette in drive A:
  258.  
  259.          CAPGNZBU A
  260.  
  261.      or
  262.       
  263.          CAPGNZBU A:
  264.  
  265.      Distributed Files
  266.      -----------------
  267.          After installation, you should have the following files in the
  268.      directory where Capital Gainz was installed:
  269.  
  270.          CAPGNZ.DOC - users manual
  271.          CAPGNZ.EXE - Capital Gainz executable
  272.          CAPGNZ.HLP - Capital Gainz help file
  273.          CAPGNZBU.BAT - example batch file for data backup
  274.          CAPGNZSH.COM - executable used for DOS shell
  275.          LICENSE.DOC - registration information
  276.          OMB.ASP - ASP Ombudsman policy
  277.          README.DOC - this file
  278.          HISTORY.DOC - a list of changes and fixes by revision
  279.          VENDOR.DOC - information for shareware disk vendors
  280.  
  281.      Bulk Loading Data
  282.      -----------------
  283.          I investigated the possibility of allowing data in the form of
  284.      ASCII text files being 'bulk loaded' into Capital Gainz through a
  285.  
  286.                                                                           5
  287.  
  288.  
  289.  
  290.  
  291.  
  292.      conversion utility, allowing users to quickly set up their investment
  293.      histories. I decided against releasing such a tool based on the fact
  294.      that the prepping of the ASCII data and subsequent manual fixup of
  295.      data file dependencies would actually be more trouble and possibly
  296.      take more time than entering the data interactively.
  297.  
  298.          I personally input several years worth of investment data using
  299.      Capital Gainz, and believe that the process is fairly easy due to the
  300.      program's structure. For instance, recording a share purchase on the
  301.      Buy Shares screen results in the record being written and the user
  302.      having the option to enter another record, with the previously entered
  303.      data still displayed, or leave the form. In fact, I went so far as
  304.      entering information on shares that had already been closed, and then
  305.      let Capital Gainz perform the selling operation so I could see
  306.      gain/loss figures for the transactions.
  307.  
  308.      Known Problems
  309.      --------------
  310.  
  311.      * Some screen color combinations result in poor visibility with
  312.      certain video monitors/boards, especially CGA. Either change the color
  313.      configuration in the Global Settings form, or use the DOS MODE command
  314.      to switch to black and white video mode:
  315.  
  316.          MODE BW80    
  317.  
  318.      * The default choice of 60 lines per page was not wise, as it results
  319.      in most laser printers printing blank or 'short' pages. A setting of
  320.      58, in the Global Settings form, is suggested. Also use this form to
  321.      tell Capital Gainz if you're using a printer that does not print the
  322.      extended ASCII line drawing characters. (Try a report, and if you get
  323.      some strange characters instead of line separators, then you probably
  324.      want to turn this option off.)
  325.  
  326.      * After you print a Price History Report from the Price History table,
  327.      Capital Gainz thinks it's showing the prices for a different security.
  328.      If you want to manipulate the table after printing a report, you
  329.      should leave the Price History table and then bring it back up. The
  330.      same problem exists for the Open Shares, Closed Shares, and
  331.      Distribution Log tables.
  332.  
  333.      * The second and subsequent times you print a report during a session,
  334.      Capital Gainz erroneously outputs an initial formfeed.
  335.  
  336.  
  337.  
  338.  
  339.  
  340.  
  341.  
  342.  
  343.                                                                           6
  344.